Release 10.1A: OpenEdge Application Server:
Administration

Creating a WSA instance

To create a WSA instance:
  1. In the Progress Explorer’s left pane, right-click on the Web Services Adapter, and click New as shown:

    2. The New Web Services Adapter dialog box appears:

  2. In the New Web Services Adapter dialog box:

    1. Supply the new WSA instance’s name and URL.
    2. Select Local or Remote, depending on whether the WSA is local or remote to the AdminServer.
    3. Choose OK.

      4. When the Progress Explorer’s left pane appears, it now contains the new WSA instance:

  3. In the Progress Explorer’s left pane, highlight the new WSA instance, right-click, and select Properties. A properties dialog box for the new appears WSA instance, like the following:

    4. In the left pane, the property categories that you can select (those not grayed out) depend on whether the WSA instance is local or remote, as shown in the following table:

    If the WSA instance is...
    The categories you can select are...
    Local
    • Location
    • Proxy Server Setting
    • WSDL
    • Logging Setting
    • Security
    • Advanced Features
    Remote
    • Location
    • Proxy Server Setting
    • Advanced Features

  4. If the WSA instance is remote, perform the following additional steps on the system where the WSA is installed:

    1. In the ubroker.properties file, copy and rename the section corresponding to the sample WSA instance provided (wsa1) to a new section—in essence, cloning wsa1’s section to a new section.
    2. Then, edit the properties in the new WSA instance’s section as desired.
  5. In the web.xml file, use a text editor (or whatever tool your JSE provides), to copy and rename the section corresponding to the sample WSA instance provided (wsa1) to a new section—in essence, cloning wsa1’s section to a new section.

Then, check and perhaps modify the web.xml items listed in Table 5–3.

Table 5–3: web.xml file items to check
Check this attribute ...
Which indicates ...
And whose default is ... 
<init-param>
   <param-name>
      InstallDir
   <param-value>
The location on disk of the OpenEdge installation directory. 
C:\Progress\OpenEdge 

<init-param>
   <param-name>
      instanceName
   <param-value>
The name of the WSA instance. 
wsa1 

<init-param> 
   <param-name>
      propertyFileName 
   <param-value>
The location of the ubroker.properties file.

Note: It need not reside in InstallDir. 

C:\Progress\OpenEdge\
properties\
ubroker.properties 

<servlet-mapping> 
  <servlet-name>
The name of the WSA servlet. 
wsa1_servlet 

<servlet-mapping> 
  <url-pattern>
The URL pattern of the WSA servlet. 
/wsa1/* 

<security-constraint>
   <auth-constraint>
      <role-name>
The role-name of the default WSA administrator. 
PSCAdmin 

<security-constraint>
   <auth-constraint>
      <role-name>
The role-name of the default WSA operator. 
PSCOper 

<security-constraint>
<user-data-constraint>
<transport-guarantee>
The type of connection for accessing WSA administration, WSDL, and Web service applications.
CONFIDENTIAL (if you are using SSL)
NONE (if you are not using SSL)

Progress Software Corporation recommends that you use names consistently when you name a remote WSA instance and when you edit entries corresponding to the remote WSA instance in the ubroker.properties and web.xml files.

Copyright © 2005 Progress Software Corporation
 www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095